home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / a_man / cat1 / csaswitch.z / csaswitch
Encoding:
Text File  |  2002-10-03  |  18.3 KB  |  265 lines
  1.  
  2.  
  3.  
  4. ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))                                                    ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      csaswitch - checks the status of, enables or disables the different types
  10.      of Comprehensive System Accounting (CSA), and switches accounting files
  11.      for maintainability
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh [_----_DDDD _l_e_v_e_l] _----_cccc _c_h_e_c_k _----_nnnn _n_a_m_e
  15.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh [_----_DDDD _l_e_v_e_l] _----_cccc _h_a_l_t
  16.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh [_----_DDDD _l_e_v_e_l] _----_cccc _o_f_f _----_nnnn _n_a_m_e_l_i_s_t
  17.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh [_----_DDDD _l_e_v_e_l] _----_cccc _o_n [_----_nnnn _n_a_m_e_l_i_s_t] [_----_mmmm _m_e_m_t_h_r_e_s_h_o_l_d] [_----_tttt _t_i_m_e_t_h_r_e_s_h_o_l_d] [_----_PPPP _p_a_t_h_n_a_m_e]
  18.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh [_----_DDDD _l_e_v_e_l] _----_cccc _s_t_a_t_u_s
  19.      _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh [_----_DDDD _l_e_v_e_l] _----_cccc _s_w_i_t_c_h
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      The _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh command checks the current status of the different types of
  23.      Comprehensive System Accounting (CSA), enables or disables them, and
  24.      switches files for maintainability.
  25.  
  26.      You can use _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh to check the current status of an accounting type
  27.      or to report the status of all types.  These functions do not require any
  28.      privileges.
  29.  
  30.      Users must have the _CCCC_AAAA_PPPP______AAAA_CCCC_CCCC_TTTT______MMMM_GGGG_TTTT capability to enable or disable an
  31.      accounting type, or to switch files for maintainability.  See the
  32.      capability(4) and capabilities(4) man pages for more information on the
  33.      capability mechanism that provides fine grained control over the
  34.      privileges of a process.
  35.  
  36.      On Trusted IRIX systems, a root user with the MAC label of _dddd_bbbb_llll_oooo_wwww will
  37.      need to execute the following command before running _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh:
  38.  
  39.           _ssss_uuuu_aaaa_tttt_tttt_rrrr _----_CCCC _CCCC_AAAA_PPPP______AAAA_CCCC_CCCC_TTTT______MMMM_GGGG_TTTT_,,,,_CCCC_AAAA_PPPP______MMMM_AAAA_CCCC______RRRR_EEEE_AAAA_DDDD_,,,,_CCCC_AAAA_PPPP______MMMM_AAAA_CCCC______WWWW_RRRR_IIII_TTTT_EEEE_,,,,_CCCC_AAAA_PPPP______MMMM_AAAA_CCCC______UUUU_PPPP_GGGG_RRRR_AAAA_DDDD_EEEE_,,,,
  40.           _CCCC_AAAA_PPPP______DDDD_AAAA_CCCC______WWWW_RRRR_IIII_TTTT_EEEE_,,,,_CCCC_AAAA_PPPP______DDDD_AAAA_CCCC______EEEE_XXXX_EEEE_CCCC_UUUU_TTTT_EEEE_++++_pppp_iiii
  41.  
  42.      You may also need the _CCCC_AAAA_PPPP______CCCC_HHHH_OOOO_WWWW_NNNN and _CCCC_AAAA_PPPP______FFFF_OOOO_WWWW_NNNN_EEEE_RRRR capabilities.  If you are
  43.      at a MAC label that is higher than _dddd_bbbb_aaaa_dddd_mmmm_iiii_nnnn, you will need  the
  44.      _CCCC_AAAA_PPPP______MMMM_AAAA_CCCC______DDDD_OOOO_WWWW_NNNN_GGGG_RRRR_AAAA_DDDD_EEEE capability instead of the _CCCC_AAAA_PPPP______MMMM_AAAA_CCCC______UUUU_PPPP_GGGG_RRRR_AAAA_DDDD_EEEE capability.
  45.  
  46.      The _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh command accepts the following options:
  47.  
  48.      _----_DDDD _l_e_v_e_l     Sets the debug level.  Level 1 is slightly verbose; level 3
  49.                   is the most verbose.  Debug output is written to standard
  50.                   error.  By default, debugging is turned off (level 0).
  51.  
  52.      _----_cccc _c_o_m_m_a_n_d   Specifies the accounting command.
  53.  
  54.                   CCCCoooommmmmmmmaaaannnndddd         DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  55.  
  56.                   _cccc_hhhh_eeee_cccc_kkkk           Reports the status for an accounting type
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))                                                    ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))
  71.  
  72.  
  73.  
  74.                   _hhhh_aaaa_llll_tttt            Turns off all accounting types
  75.  
  76.                   _oooo_ffff_ffff             Disables one or more types of accounting
  77.  
  78.                   _oooo_nnnn              Enables one or more types of accounting
  79.  
  80.                   _ssss_tttt_aaaa_tttt_uuuu_ssss          Reports the status of all types of
  81.                                   accounting
  82.  
  83.                   _ssss_wwww_iiii_tttt_cccc_hhhh          Specifies that a new accounting file should
  84.                                   be created to maintain manageable files.
  85.                                   Suppose the accounting filename is
  86.                                   _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt.  _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh moves
  87.                                   the current accounting file
  88.                                   _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt to the next
  89.                                   available file _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt_**** and
  90.                                   then calls _aaaa_cccc_cccc_tttt_cccc_tttt_llll(3C) using the file
  91.                                   argument /_v_a_r/_a_d_m/_a_c_c_t/_d_a_y/_p_a_c_c_t.  In this
  92.                                   way, accounting data is not lost, and
  93.                                   _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt remains the current
  94.                                   file.
  95.  
  96.      _----_nnnn _n_a_m_e      Specifies the _n_a_m_e of the accounting type for which a
  97.                   request is being made.  The _n_a_m_e_l_i_s_t argument for the _oooo_ffff_ffff
  98.                   and _oooo_nnnn commands can be a single name or a comma-separated
  99.                   list of names.
  100.  
  101.                   Valid process accounting names are:
  102.  
  103.                   NNNNaaaammmmeeee                DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  104.  
  105.                   _cccc_ssss_aaaa                 CSA accounting
  106.  
  107.                   Valid daemon  names are:
  108.  
  109.                   NNNNaaaammmmeeee           DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  110.  
  111.                   _nnnn_qqqq_ssss            Network Queuing System (NQS) daemon
  112.                                  accounting
  113.  
  114.                   _wwww_kkkk_mmmm_gggg           Workload management daemon accounting
  115.  
  116.                   _tttt_aaaa_pppp_eeee           Tape daemon accounting
  117.  
  118.                   Valid record names (linked to the CSA base record):
  119.  
  120.                   NNNNaaaammmmeeee           DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  121.  
  122.                   _iiii_oooo             Input and output data record
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))                                                    ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))
  137.  
  138.  
  139.  
  140.                   _mmmm_eeee_mmmm            Memory data record
  141.  
  142.                   Valid threshold names are:
  143.  
  144.                   NNNNaaaammmmeeee           DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  145.  
  146.                   _mmmm_eeee_mmmm_tttt           Memory threshold
  147.  
  148.                   _tttt_iiii_mmmm_eeee           CPU time threshold
  149.  
  150.      _----_mmmm _m_e_m_t_h_r_e_s_h_o_l_d
  151.                   Specifies the virtual memory high-water mark below which
  152.                   accounting records will not be written.  The threshold
  153.                   should be specified in Kbytes and as an integer. The _----_mmmm
  154.                   option must be specified when the _m_e_m_t operand is specified
  155.                   with the _----_nnnn option.
  156.  
  157.      _----_tttt _t_i_m_e_t_h_r_e_s_h_o_l_d
  158.                   Specifies the number of CPU seconds below which accounting
  159.                   records will not be written.  The threshold should be
  160.                   specified as an integer.  The _----_tttt option must be specified
  161.                   when the _t_i_m_e operand is specified with the _----_nnnn option.
  162.  
  163.      _----_PPPP _p_a_t_h_n_a_m_e  Specifies the pathname of the file to which accounting data
  164.                   is written.  If the file exists, accounting records are
  165.                   appended to it.  Otherwise, _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh creates a new file;
  166.                   and it sets the owner of the file to _aaaa_dddd_mmmm, the group to the
  167.                   value of the _CCCC_HHHH_GGGG_RRRR_PPPP parameter in the _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file, and
  168.                   the mode to _0000_6666_6666_4444.  On Trusted IRIX systems, _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh sets
  169.                   the MAC label of the file to _dddd_bbbb_aaaa_dddd_mmmm_iiii_nnnn.
  170.  
  171.      If you specify the _oooo_nnnn command and do not specify the _----_nnnn option, the
  172.      _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh command gets information about which accounting types and
  173.      thresholds to enable from the _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file.
  174.  
  175.      When you enable an accounting type, if no accounting type is currently
  176.      on, you need to specify the accounting pathname via the _----_PPPP option.  If
  177.      you do not specify the _----_PPPP option, _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh gets the pathname from the
  178.      _PPPP_AAAA_CCCC_CCCC_TTTT______FFFF_IIII_LLLL_EEEE parameter in the _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file.  If that parameter does
  179.      not exist, then _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh uses _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt.
  180.  
  181.      When you turn on a linked record, _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh turns on _cccc_ssss_aaaa accounting (if
  182.      it is not on already) since there can be no linked records without the
  183.      base record.  The same happens when you set a threshold since thresholds
  184.      will not have any effect if _cccc_ssss_aaaa is not running.  Likewise, when you turn
  185.      off _cccc_ssss_aaaa accounting, _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh turns off all the linked records and
  186.      thresholds.
  187.  
  188.      When you switch the _p_a_c_c_t file, if no accounting type is currently on,
  189.      _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh turns on accounting.  It gets information about which
  190.      accounting types and thresholds to enable from the _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file.
  191.      It also gets the accounting pathname from the _PPPP_AAAA_CCCC_CCCC_TTTT______FFFF_IIII_LLLL_EEEE parameter in the
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))                                                    ccccssssaaaasssswwwwiiiittttcccchhhh((((1111MMMM))))
  203.  
  204.  
  205.  
  206.      _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff file.  If that parameter does not exist, then _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh
  207.      uses _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt.
  208.  
  209. NNNNOOOOTTTTEEEESSSS
  210.      The _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh command does not support IRIX System V or extended
  211.      accounting.
  212.  
  213.      The _cccc_ssss_aaaa_cccc_kkkk_pppp_aaaa_cccc_cccc_tttt(1M) shell script invokes _cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh to maintain accounting
  214.      files of a reasonable size.  You should run _cccc_ssss_aaaa_cccc_kkkk_pppp_aaaa_cccc_cccc_tttt(1M) periodically
  215.      by using _cccc_rrrr_oooo_nnnn(1M).
  216.  
  217. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  218.      Example 1:  The following command turns on _cccc_ssss_aaaa accounting with the
  219.      default _pppp_aaaa_cccc_cccc_tttt file:
  220.  
  221.           _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh _----_cccc _oooo_nnnn _----_nnnn _cccc_ssss_aaaa
  222.  
  223.      Example 2:  The following command checks the status of _mmmm_eeee_mmmm accounting:
  224.  
  225.           _////_uuuu_ssss_rrrr_////_llll_iiii_bbbb_////_aaaa_cccc_cccc_tttt_////_cccc_ssss_aaaa_ssss_wwww_iiii_tttt_cccc_hhhh _----_cccc _cccc_hhhh_eeee_cccc_kkkk _----_nnnn _mmmm_eeee_mmmm
  226.  
  227.                #       Accounting status for Thu Feb  3 16:41:48 2000
  228.                #             Name      State   Value
  229.                              mem       On
  230.  
  231.  
  232. FFFFIIIILLLLEEEESSSS
  233.      _////_eeee_tttt_cccc_////_cccc_ssss_aaaa_...._cccc_oooo_nnnn_ffff                         Accounting configuration file
  234.  
  235.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt               Current accounting file
  236.  
  237.      _////_vvvv_aaaa_rrrr_////_aaaa_dddd_mmmm_////_aaaa_cccc_cccc_tttt_////_dddd_aaaa_yyyy_////_pppp_aaaa_cccc_cccc_tttt_****              Switched accounting files
  238.  
  239. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  240.      cron(1M), csa(1M), csackpacct(1M), capability(4).
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.